## Game Status v5.6.0

Scroll down for the setup instructions.

![Game is playable!](static/LOGO-IF-WORKING.jpg)
<!-- ![Work in progress](static/LOGO-IF-WIP.jpg) -->


**Supported versions:** International, China (channel 1 and 14)

Note: as reported in [Issue#401](https://notabug.org/Krock/dawn/issues/401), the CN game
servers are likely to prevent players on Linux and macOS from logging in for unknown reasons.


### Situation

Before game version 3.8.0, a patch was needed to work around the game's cheat prevention kernel service which is and will not be supported by Wine.
Since version 3.8.0 no additional patches are needed and the game is playable (almost) out of the box (&#x1F389;).
To get the best gaming experience please check the setup instructions below.


**Similar games. Format: link, caveats (Proton/Wine rating)**

 * [Unending Dawn](https://www.youtube.com/watch?v=BsA3OckCW7g), via PS5 emulator?, unknown (to be released)
 * [Ananta](https://www.anantagame.com/) (previously Project Mugen), unknown (to be released)
 * [Neverness to Everness](https://nte.perfectworld.com/), unknown (to be released)
 * [Arknights Endfield](https://endfield.gryphline.com/), unknown (to be released)
 * Zenless Zone Zero, singleplayer (works)
 * [Scarlet Nexus](https://store.steampowered.com/app/775500/SCARLET_NEXUS/), singleplayer (Platinum)
 * [Granblue Fantasy: Relink](https://store.steampowered.com/app/881020/Granblue_Fantasy_Relink/), singleplayer (Platinum)
 * [Little Witch Nobeta](https://store.steampowered.com/app/1049890/Little_Witch_Nobeta/), singleplayer (Gold)
 * [Europa](https://store.steampowered.com/app/2214880/Europa/), singleplayer, no waifu (unknown)
 * [Ashen](https://store.steampowered.com/app/649950/Ashen/) (Platinum)
 * [Reverse: 1999](https://store.steampowered.com/app/3092660/Reverse_1999/), 2.5D, singleplayer (Gold)
 * [Tower Hunter: Erza's Trial](https://store.steampowered.com/app/844850/Tower_Hunter_Erzas_Trial/), singleplayer, 2D scroller (Platinum)
 * [Haven](https://www.gog.com/game/haven), PEGI 18 (Gold)
 * [Pine](https://www.gog.com/game/pine), no story, singleplayer (Native)
 * ~~Tower of Fantasy~~ (Broken: anticheat)

*This list is incomplete. <https://areweanticheatyet.com/> might provide information about specific titles.*

**Related compatibility projects**

 * [jadeite](https://codeberg.org/mkrsym1/jadeite): HI3 patch
     * Relevant 3rd party launcher: Honkers Launcher (GitHub)
 * [jadeite](https://codeberg.org/mkrsym1/jadeite): HSR patch
     * Relevant 3rd party launcher: The Honkers Railway Launcher (GitHub)
 * [jadeite](https://codeberg.org/mkrsym1/jadeite): Wuthering Waves patch
     * Relevant 3rd party launcher: N/A
 * Punishing: Gray Raven
     * Compatible by using the modified "Reverse: 1999" binary. See [Issue#454](https://notabug.org/Krock/dawn/issues/454).
     * ~~[Borb Launcher](https://github.com/an-anime-team/an-anime-borb-launcher)~~ (no longer maintained)
     * Relevant 3rd party launcher: [Babylonia](https://github.com/ALEZ-DEV/Babylonia-terminal) (CLI)


### Project rules

 1. miHoYo reserves the right to distribute files. Please do not share any game data in public.
 2. For your own sake: **Please do not share this project in public**.
    * Reduces the risk of this project to be taken down or used against our reverse-engineering efforts
    * Solution: Use indirect/redirect links and private messages
 3. Please do not abuse this project for cheating. We just want to play the game.

For project contributors: Beware that your log files may contain personal information, such as MAC addresses or login data.


### [Game installation instructions](INSTALLATION.md)

Please check the [Game installation instructions](INSTALLATION.md) for the minimal
requirements and a guided installation of the game using Lutris, Steam, macOS or
custom scripts.

Afterwards, it is recommended to execute `patch.sh` so that `launcher.bat` is generated
within the game directory because all instructions assume its presence. Note: the main
patch script no longer modifies any game files and is considered harmless.

Follow the script as instructed. `GAMEVER` stands for the game version, i.e. `3.2.0` becomes `320`.

	# Download the repository (or use the download button)
	git clone https://notabug.org/Krock/dawn --depth 1

	# Tip: Drag&drop the desired directory or file into the terminal to copy its path

	cd "/path/to/Genshin Impact Game"
	bash "/path/to/dawn/GAMEVER/patch.sh"

	# Start the game after checking the domains
	wine cmd /c launcher.bat

To stay up-to-date with the blocked domains, it is recommended to re-run the "patch" script
after each game update.

**Undo**

Old patch residues can be removed by executing `patch_revert.sh` in the same manner
as `patch.sh` above. To remove the blocked logging servers, edit `/etc/hosts` with
superuser permissions.


### [Troubleshooting](TROUBLESHOOTING.md)

Please **do not report any** game issues to an official channel. Your options are:

 * [Troubleshooting](TROUBLESHOOTING.md) page for common issues and solutions
 * Create a [new issue](https://notabug.org/Krock/dawn/issues) here. See also: [closed/solved issues](https://notabug.org/Krock/dawn/issues?state=closed&labels=2029)
 * Post your problem on a Wine/dxvk-specific page

### [Frequently Asked Questions](FAQ.md)

### [Game updater & patch](updater/)

### [Performance & visual tweaks](TWEAKS.md)

### [Credits](CREDITS.md)

License: MIT
